home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / strtok.0 < prev    next >
Text File  |  1996-09-02  |  2KB  |  46 lines
  1.  
  2. STRTOK(3)                  UNIX Programmer's Manual                  STRTOK(3)
  3.  
  4. NNAAMMEE
  5.      ssttrrttookk, ssttrrsseepp - string token operations
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttrriinngg..hh>>
  9.  
  10.      _c_h_a_r _*
  11.      ssttrrttookk(_c_h_a_r _*_s_t_r, _c_o_n_s_t _c_h_a_r _*_s_e_p)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      TThhiiss iinntteerrffaaccee iiss oobbssoolleetteedd bbyy ssttrrsseepp((33))..
  15.  
  16.      The ssttrrttookk() function is used to isolate sequential tokens in a null-
  17.      terminated string, _s_t_r. These tokens are separated in the string by at
  18.      least one of the characters in _s_e_p. The first time that ssttrrttookk() is
  19.      called, _s_t_r should be specified; subsequent calls, wishing to obtain fur-
  20.      ther tokens from the same string, should pass a null pointer instead.
  21.      The separator string, _s_e_p, must be supplied each time, and may change be-
  22.      tween calls.
  23.  
  24.      The ssttrrttookk() function returns a pointer to the beginning of each subse-
  25.      quent token in the string, after replacing the separator character itself
  26.      with a NUL character.  When no more tokens remain, a null pointer is re-
  27.      turned.
  28.  
  29. SSEEEE AALLSSOO
  30.      index(3),  memchr(3),  rindex(3),  strchr(3),  strcspn(3),  strpbrk(3),
  31.      strrchr(3),  strsep(3),  strspn(3),  strstr(3)
  32.  
  33. SSTTAANNDDAARRDDSS
  34.      The ssttrrttookk() function conforms to ANSI C3.159-1989 (``ANSI C'').
  35.  
  36. BBUUGGSS
  37.      There is no way to get tokens from multiple strings simultaneously.
  38.  
  39.      The System V ssttrrttookk(), if handed a string containing only delimiter char-
  40.      acters, will not alter the next starting point, so that a call to
  41.      ssttrrttookk() with a different (or empty) delimiter string may return a non-
  42.      NULL value.  Since this implementation always alters the next starting
  43.      point, such a sequence of calls would always return NULL.
  44.  
  45. 3rd Berkeley Distribution        June 29, 1991                               1
  46.